home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / f90 / ubound.z / ubound
Encoding:
Text File  |  2002-10-03  |  2.7 KB  |  63 lines
  1. UBOUND(3I)                                            Last changed: 4-13-99
  2.  
  3.  
  4. NNAAMMEE
  5.      UUBBOOUUNNDD - Returns all the upper bounds of an array or a specified upper
  6.      bound
  7.  
  8. SSYYNNOOPPSSIISS
  9.      UUBBOOUUNNDD (([AARRRRAAYY==] _a_r_r_a_y [,,[DDIIMM==]_d_i_m]))
  10.  
  11. IIMMPPLLEEMMEENNTTAATTIIOONN
  12.      UNICOS, UNICOS/mk, IRIX systems
  13.  
  14.      CF90, MIPSpro 7 Fortran 90
  15.  
  16. SSTTAANNDDAARRDDSS
  17.      Fortran
  18.  
  19. DDEESSCCRRIIPPTTIIOONN
  20.      The UUBBOOUUNNDD intrinsic function returns all the upper bounds of an array
  21.      or returns a specified upper bound.  It accepts the following
  22.      arguments:
  23.  
  24.      _a_r_r_a_y     Can be of any type.  It must not be scalar.  It must not be
  25.                a pointer that is disassociated or an allocatable array that
  26.                is not allocated.  If _a_r_r_a_y is an assumed-size array, _d_i_m
  27.                must be present with a value less than the rank of _a_r_r_a_y.
  28.  
  29.      _d_i_m       Must be scalar and of type integer with a value in the range
  30.                1 <= _d_i_m <= _n, where _n is the rank of _a_r_r_a_y.  The
  31.                corresponding actual argument must not be an optional dummy
  32.                argument.
  33.  
  34.      UUBBOOUUNNDD is an inquiry function.  The name of this intrinsic cannot be
  35.      passed as an argument.
  36.  
  37. RREETTUURRNN VVAALLUUEESS
  38.      The result type is default integer.  It is scalar if _d_i_m is present;
  39.      otherwise, the result is an array of rank one and size _n, where _n is
  40.      the rank of _a_r_r_a_y.
  41.  
  42.      For an array section or for an array expression, other than a whole
  43.      array or array structure component, UUBBOOUUNNDD((_a_r_r_a_y,,_d_i_m)) has a value
  44.      equal to the number of elements in the given dimension.  It has a
  45.      value equal to the upper bound for subscript _d_i_m of _a_r_r_a_y if dimension
  46.      _d_i_m of _a_r_r_a_y does not have size zero; it has the value zero if
  47.      dimension _d_i_m has size zero.
  48.  
  49.      UUBBOOUUNNDD((_a_r_r_a_y)) has a value whose _ith component is equal to
  50.      UUBBOOUUNNDD((_a_r_r_a_y,,_i)), for _i = 1, 2, ..., _n, where _n is the rank of _a_r_r_a_y.
  51.  
  52. EEXXAAMMPPLLEESS
  53.      Assume that AA is declared by the statement RREEAALL AA((22::33,, 77::1100)).  In this
  54.      case, the following are true:
  55.  
  56.      * UUBBOOUUNNDD((AA)) is ((//33,, 1100//)).
  57.  
  58.      * UUBBOOUUNNDD((AA,, DDIIMM == 22)) is 10.
  59.  
  60. SSEEEE AALLSSOO
  61.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l for the printed version of this
  62.      man page.
  63.